home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / proc_ref.z / proc_ref
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  66 lines
  1.  
  2.  
  3.  
  4. pppprrrroooocccc____rrrreeeeffff((((DDDD3333))))                                                      pppprrrroooocccc____rrrreeeeffff((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_rrrr_oooo_cccc______rrrr_eeee_ffff - obtain a reference to a process for signaling
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _vvvv_oooo_iiii_dddd _****_pppp_rrrr_oooo_cccc______rrrr_eeee_ffff_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      A non-STREAMS character driver can call _pppp_rrrr_oooo_cccc______rrrr_eeee_ffff to obtain a reference to
  18.      the process in whose context it is running.
  19.  
  20.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  21.      _pppp_rrrr_oooo_cccc______rrrr_eeee_ffff returns an identifier that can be used in calls to _pppp_rrrr_oooo_cccc______ssss_iiii_gggg_nnnn_aaaa_llll
  22.      and _pppp_rrrr_oooo_cccc______uuuu_nnnn_rrrr_eeee_ffff(D3).
  23.  
  24. UUUUSSSSAAAAGGGGEEEE
  25.      The value returned can be used in subsequent calls to _pppp_rrrr_oooo_cccc______ssss_iiii_gggg_nnnn_aaaa_llll(D3) to
  26.      post a signal to the process.  The return value should not be used in any
  27.      other way (that is, the driver should not attempt to interpret its
  28.      meaning).
  29.  
  30.      Processes can exit even though they are referenced by drivers.  In this
  31.      event, reuse of the identifier will be deferred until all driver
  32.      references are given up.
  33.  
  34.      There must be a matching call to _pppp_rrrr_oooo_cccc______uuuu_nnnn_rrrr_eeee_ffff for every call to _pppp_rrrr_oooo_cccc______rrrr_eeee_ffff,
  35.      when the driver no longer needs to reference the process.  This is
  36.      typically done as part of _cccc_llll_oooo_ssss_eeee(D2) processing.
  37.  
  38.      This function requires user context.
  39.  
  40.    LLLLeeeevvvveeeellll
  41.      Base only.
  42.  
  43.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  44.      Does not sleep.
  45.  
  46.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  47.      across calls to this function.
  48.  
  49. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  50.      _pppp_rrrr_oooo_cccc______ssss_iiii_gggg_nnnn_aaaa_llll(D3), _pppp_rrrr_oooo_cccc______uuuu_nnnn_rrrr_eeee_ffff(D3)
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.